home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 23 / AACD 23.iso / AACD / Programming / Warp3D_Devel / README.vbcc < prev    next >
Text File  |  2001-02-08  |  2KB  |  65 lines
  1.                                Warp3D for vbcc
  2.                   -----------------
  3.  
  4.  
  5. INTRODUCTION
  6.     The Warp3D support for vbcc-M68k and vbcc-WarpOS comes with a
  7.     linker library and a special include files, which contains the
  8.     assembler inlines for calling all functions of Warp3D. The linker
  9.     libraries will only be needed, if the address of a Warp3D function
  10.     is required.
  11.  
  12.  
  13. REQUIREMENTS
  14.     vbcc 0.7. Older versions, like vbcc 0.6 for M68k or vbcc 0.6c
  15.     for WarpOS, might work too, but better get the last official
  16.     release from Aminet to avoid problems.
  17.  
  18.  
  19. INSTALLATION
  20.     For M68k:
  21.         copy LLibs/w3d_vbcc68k.lib vlibm68k:w3d.lib
  22.         copy Include/proto/#? vincludem68k:proto/
  23.         copy Include_vbcc/inline_68k/#? vincludem68k:inline/
  24.  
  25.     For PowerPC/WarpOS:
  26.         copy LLibs/w3d_vbccwos.lib vlibwos:w3d.lib
  27.         copy Include/proto/#? vincludewos:proto/
  28.         copy Include_vbcc/inline_PPC/#? vincludewos:inline/
  29.     (If vincludewos:inline doesn't exist, create it first.)
  30.  
  31.     Additionally you need to copy the following include files from
  32.     the standard Warp3D distribution to your normal include path:
  33.         Include/Warp3D/Warp3D.h
  34.         Include/clib/Warp3D_protos.h
  35.  
  36.     Optionally, you may copy the FD-files from include/fd/ to FD:.
  37.  
  38.  
  39. USAGE
  40.     The only difference from SAS/C, egcs or StormC is that you *must*
  41.     include "proto/Warp3D.h" to be able to use the Warp3D assembler
  42.     inline functions. Pragma-includes are unnecessary for vbcc, but if
  43.     you accidently include them, they will be ignored.
  44.  
  45.     In most cases you don't need to link with w3d.lib, but it doesn't
  46.     matter if you do. There are only two cases, where stub routines
  47.     from w3d.lib will be used:
  48.     1. You didn't include the vbcc-specific proto/Warp3D.h
  49.     2. The program needs the address of a Warp3D function.
  50.  
  51.     Example for compiling a Warp3D program using CyberGfx and
  52.     math functions.
  53.     M68k: vc -cpu=68020 -fpu=68881 -o test test.c -lw3d -lcgfx -lm881
  54.     WOS:  vc +warpos -amiga-align -o test test.c -lw3d -lcgfx -lamiga -lm
  55.  
  56.  
  57. BUGS
  58.     Contact me, if there are any problems with the vbcc includes or
  59.     libraries, but I will not be able to reproduce bugs, because I
  60.     don't have any 3D-hardware.
  61.  
  62.  
  63.  
  64. Frank Wille                  21-Jan-2000                frank@phoenix.owl.de
  65.